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Apple releases new peripherals 

Apple, Inc announced several new peripherals for the Apple 11 family on 
September 17— just in time for the Christmas season. The new products 
indude two composite color monitors that can display 80-column text an 
up^aded Imagewriter 11 printer, and an 800K double-sided 5-1/2 inch disk 
drive. Mot included in the announcement though widely e^qpected, was the 
AppleTalk network card. Also announced, but without a price or availability 
date, was a 256K memory card, which is expandable to 1 megabyte. 

At the same time, Apjde annoimeed fiat its sales durkig July and August 
(in the wake of this summer's Atari and Commodore product introductions) 
were stronger than it had expected. Apple said it was reinstating plans for a 
big Christmas advertising campaign, which had been cancelled earlier this 
year after Apple reported its first quarterly loss (see our July issue, page 49), 

In my opinion, the most significant of the new Apple products are the color 
monitors— assuming they do what Apple's press releases say they will. 
These monitors, which will sell for about $400, display both color and 80- 
column text, yet hook up to the standard Apple video connector. Previously, 
the only way to get both color and 80-column text on the same screen was 
with RGB (red-green-blue) equipment This was significantly more expensive. 
Apple announced that its new monitors -one matches the lie styling, the 
other lie styling— would rq>lace its $600 RGB monitor. I hear bells tolling for 
RGB. 

next in significance was the tack of an AppleTalk announcement Earlier in 
September Apple sent letters to people v^o had purchased the Applellalk 
De^oper^s Notes for the Apple II refiinding their money and saying that the 
notes should be disregarded. Apparently early developers had complained 
about the card's performance and Apple decided to redesign it 'This 
redesign will allow developers to shorten and ease their design cyde" the 
letter said 

The new $600 Imagewriter II printer has four significant enhancements. A 
fast 250 character-per-second draft mode and a slow 45 character-per- 
second near-letter-quality mode were added to the Imagewritefs standard 
180 character-per-second operation. With a special $14 ribbon, the Imagewriter 
II will print in color. It includes an expansion slot and Apple is producing a 
$100 32K memory board for the slot Also available is a $225 single-sheet 
feeder. It also has one significant de-enhancement; the cable that used to 
come with the printer is now $30 extra. 

The most insipificant products are the new "UniDisk 3.5" and the "Apple 
II Memory Expansion Card." The only bright things that can be said about 
these products is that they work on all models of the Apple 11, The price and 
availability of the memory expansion card had not even been set at the time 
of Apple's announcement 

The expansion card fits in a standard Apple II slot and appears to be useful 
primarily as a RAM disk. Almost all of the software developers who say they 
are supporting the card are using it this way Its addressing scheme is totally 
different fi'om any other Apple 11 memory card on the market It reportedly 
does not use bank switching. To read to or write ft-om the card you repeatedly 
peek or poke at the same memory address in the Softswitch area for the slot 
the card is in. The card provides a serial stream of data in response. You can 
move the "position in card" pointer elsewhere by poking a couple of other 
softswitches on the card. 

Meanwhile, ^plied E^pieering has dropped the price of its 1-megabyte 
auxiliary-slot RAM card to $519 and announced that it can be expanded to 
23 megabytes. Checkmate Technology has announced a 768K board for the 



Apple lie and a 512K board the Apple lie ttiat indude 65816 microprocessors. 
And Apple made no announcements about supporting AppleWorks with its 
memory card; something both Applied Engineering and Checkmate have 
accomplished. Whaf s the big deal? 

Apple's memory card almost looks significant however, when compared 
to the new 3-1/2 inch disk drive. The UniDisk 3.5 costs $500 and requires a 
separate $69 controller card when used on a ll-Plus or He. This controller is 
incompatible with 5-1/2 inch drives. The new drive does plug directly into a 
11c, but the 11c requires a modification to its internal disk control firmware 
before the new drive will work. Apple dealers will make this modification, 
apparently without charge, when a 11c owner purchases the new drive. 

The new drive does not support DOS 3.3 or CP/M. Programs written in 
Pascal must be revised to use it 

Compare the 800K UniDisk 3.5 at $568 to a 10,000K Sicter hard drive at 
$700 and tell me how^ple expects to sell these things. Throwin the cost of 
a box of thespedai doublersided 3-1/2 inch disks the newdrive requires and 
you are within $100 of the Sider. 

The Sider supports ProDOS, DOS 3.3, Pascal, and CP/M; the UniDisk 3,5 
supports only ProDOS. The Sider is three times faster than a standard floppy; 
the UniDisk only two times faster. 

Perhaps realizing its problems, Apple notes in its press release on the 
UniDisk 3.5 that the drive's "mass storage capability also makes it a cost 
eff'ective backup solution for hard disk drive users." 

You want a cost-effective backup solution for a Sider? Buy another one. Its 
cheaper and easier than anything else you can do. In addition, not only do 
you have your data backed up; you have your equipment backed up as well. 

The UniDisk 3.5 may find a niche market as a ProDOS-only add-on drive for 
the Apple He I can think of no other cost-^fFeetive for it 
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Butleillies turn to worms 

What I like best about Logo and the Logo philosophy is Oiat bugs are 
considered opportunities rafiier than disasters. A bug encounter to a Logo 
programmer is a learning experience. 

IVe had a lot of these learning experiences this month. Several of the 
public domain butterflies Open-Apple set loose upon the world earlier this 
year have turned to worms during the last 30 days. In this month's issue wc'U 
investigate what happened and all come out better people for it 

Input anything bugs. Last month's /nput^so(utei^/lni/ihmg program 
and article had both dumb mistakes and exotic ones. Uirn, if you will to page 
67 and look at the second program on that page. Install IM.OBJ, Look at the 
amazing sequence of line numbers given. We have scientiilcal^ determined 
that the program will woili a lot better if you renumber llie third through tlie 
seventh lines. Make the third line 115 and increm^t the line numbw by 5 
until you get to line 130. The new line 125 and the old line 160 should also 
have the word REM after their colons (and stop that tittering). 

Moving beyond pure stupidity, a much more interesting discovery about 
Input Absolutely Anything is that under DOS 55, strings don't evaluate 
correctly with the VAL function, just as they didn't with Crossle/s original 
input-anything routine^ as mentioned on page 66. The problem is the same 
as Crossley's— the string characters are being stored with the high-bit set 
(h^lHalue ASCII format) rather than with the high-bit dear as Applesoft 
expects. In additbn to problems with the VAL function, string comparisions 
don't work reliabty Vi^en some strings are in hl^-value ASCII and some in 
low-value. 

(On page 66, 1 said this problem was originally solved in the June 1980 (Ml 
■ARRLE. by Eric Qoez. This statement was an interpolated estimate Uiat 
also turned out wrong The Qoez article, now that 1 have actually found it was 
an Applesoft input-anything routine based on the GET command. The first 
input-anything routine I can find that solved ttie VAL problem was, appropriately 
enough, Val Qolding's. It appeared in the July 1980 Call -ARRLE J 

The difference between Crossley and me, of course, is that I knew about 
the potential high-bit problem. My routine takes pains to clear a character's 
hi^ bit before storing it in the input buffer, i realized i was in big iiouble, 
howevo; %4ien I got the fiolkiwing letter from Jack James of Winfldd, lib 

/ recently wrote my own Input Emrything" routine for the same reasons 
you gave for writing yours. My immediate problem was mmparing two text 
files holding LISTed versions of an Applesoft program. The program was a 
commercial produd that packed lots of<x)mmands into single statements. 
The LISTed vei^on of these statements urn often longer than 255 
dmaidtm. The pro^m aSiso tndvaded embedded backspaces and other 
control charactcra, some of which were intercepted by FiXKflAR and 
treated as editing commands. 

My program, like yours, is based on Peter Meyer's ^Wimate Input-Mearty- 
Anything Routine". I replaced the nXKMAR call with Applesoft's mCfIR 
routine ($D553) rather than the Monitor's ROm. IfiCMR calls RD^Yand 
then clears the high bit of the returned character / used COUT, as you do, to 
echo the character and, for disk reads, to satisfy DOS's eat-the-character 
mechanism. 

You dkint point out (hat our routines will read aU 128 ASCII characters, 
Indudlf^ corM^ MSC£r OA uMch OCT wiU not handle. (This character 
must hsm the fdgh-tU set lOten It Is data on the dfsk Tfds sets it apart from 
Ute textpie terminsAoi whicft Is a true lero—f^h M dean) 

You were also rather cryp^ about dealing with brings lor^er than 255 
characters. These routines blindly return the first 255 characters of long 
strings without knowing whether the 256th is a carriage return. This means 
that an application program that wants to handle long strings must check 
the returned string length. If it is 255, there is always more and a 
subsequent read must be done. If the string is, in fact, exactly 255 
characters long, that read will yield a lone carris^e return and, hence, a null 
string. Otherwise, of course, you'll get more. 

In the process of developing my routine, I found (with the help of Lee 
Meador, Call -ARRLL's DOS consultant in Dallas) an unimal characteristic 
of DOS 5,5. Mhm(^ I um the M of eatM dmmder before 
putting it into the trq)ut buffer at $2(X), tfte %h M was set on all but the last 
character o/ my returned strings. Ittums out that DOS 5.3 expects page 2 to 
be used for the input buffer and goes through the trouble to make sure any 
characters it places there have the high bit set Eadi time I asked DOS to 



read another character from the file, it would set the high bit on the 
previous character in the page-2 input buffer. 

I ended up using Applesoft's GDBUFS ($D559), as Meyer had done, to 
clear the high bits. The high-bit clear by DOS not only undid what I had 
already done, but it carries the potentlMt^dobberif^page 2 if you are 
u^gttforsom^ngelse. 

So its Uncle DOS himself who's spoiling Open-Apple's input-anything 
routine. (And i thought we were fiiends.) The oiFending code inside DOS 3.3 
(this isn't a problem under ProDOS) lives at $A64Ar$A65D and is executed 
every time READ gets a character from the disk. 

Here's a complete Applesoft fix for this problem. Use these lines in place of 
the originals given in September's Create lAAOBJ (page 67— enter B 
iiAieie yoa see b; enter 8 where you see B or 

100 C$="0300: m 84 85 33 20 E3 DF 20 GC DD fl2 00 20 0C FO" : GDSUB 500 

101 CS="030F: R8 23 7F C9 00 08 48 F0 0? CS 20 b0 03 68 40^' : GQSUB 500 

102 C$="031E: m 33 20 ED FO 6B 28 F0 0D 3D 00 02 EB E0 FF" : GOSUB 500 

103 C$="032D: D0 DD m 00 20 ED FD 86 FD 20 39 D5 fl6 FO Bfi" : GQSUB 500 

104 C$="033C: fl0 00 01 83 F0 02 b0 IF 91 83 CB bl B3 B5 71" : GOSUB 500 

105 C$="034b: 4B CB bl 83 85 72 C5 70 68 90 00 C5 GF 90 09" : GOSUB 500 
10G CJ-"035P: afi fi2 00 m 02 20 E2 E5 G0 Bfl 20 52 E4 R2 00" : GOSUB 500 

107 Ct="03Gg: m 02 20 12 E5 fl0 00 flS FD 91 83 CS fi5 GF 91" : GOSUB 500 

108 CS="037B: B3 CB 95 70 91 63 60" : GQSUB 500 
110 FOR 1=768 TO 894 : X=X+PE£:K(I) ; NEXT 

120 IF X=lG3ei THEN 200 

Assemb^ language programmers might want to make a note in the 
source axle on page 68 of last month's letter. Just before the TXA command 
at byte $333 enter this: 

JSR $0539 flppissaft GOBUFS clears high bits that DOS 3.3 messed up 
LDX LtMINS recover string length 

Leave the TXA instruction intact it may seem quicker to just LDA LENIMS, 
but both X and A must have the string length for the program to work 
correctly later on. 

The routine James sent me is executed with a CALL command rather than 
with the ampersand my routine used. His Applesoft syntax is to put a comma 
after the CALU followed by the string variabie, like this: 

CPLL 7SB,fl$ 

He executes this with three calls to Applesoft machine language routines: 

J5R CHKCOW (IDEBE) looks for and eats cofflma after CALL command 

JSR PTRGET ($DFE3) digs user's variable out of program 

JSR CHK5TR ($0D6C] makes sure variable is a string variable 

If you would prefer to use the CALL ^tax, all you have to do is add the JSR 
COMCHK instruction before the JSR PTRQET in n^ program. The program 
assembles to run at $500 (CALL 768). but can be loaded anywhere that is 
convenient without reassembly. 

I didn't know about CHKSTR As presented last month, Input Absolutely 
Anything will choke if you give it a numeric variable instead of a sting 
variable. For example, "8f A" instead of "6f A$" will cause problems. James 
avoids these problems by the call to CHKSTR, which will return a TYPE 
MISMATCH error if the variable isn't a string variable. 

The new program lines for Create LHOfiJinclude the string-checking call 
to CHKSTR and the fix-the-high-bits call to GDBUFS. The byte that controls 
the maximum length of strings (originally mentioned on page 66. second 
p£Q:agmph) is now at byte 812 ($3X). Sony for the confusion, But chinHip. It 
getswtxse. 

Bask Bask copy program can't copy Bask programs. Qeeesh, can 
you believe tiiis one? Doesn't anj^one test stuff before publishing it? July's 
basic Basic copy program (page 51) copies Applesoft programs just fine (I 
tested that thoroughly), it's just that these copies won't WM and won't UST 
correctly (as several subscribers have pointed out). 

The problem here is that Open-Applefs basic Basic copy program does 
nothing to correct the AVX-TYPE entry in the copied file's directory, 
AUX_TYFE holds various kinds of information, depending on the file's type. 
Applesoft program files use AUX_TYPE to store the address the program was 
atvt^en it was saved. 

For more details about AUXJTYPE, see my comments after the letter 
I and CRC^TEIn the August issue^ pgge 63i 

July's Basic copy program aiws^ leaves AUX-TYPE set to zera To 
understand the problems this causes, you have to know what an Applesoft 
program line looks like in mem(xy Entsor the following progmi and follow 
along: 
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:e INPUT Rs 

2a PRINT Rl - - 

3a END 

m-isi 

300.816 

3B00- 00 09 08 m 00 84 41 24 
3808- 00 11 08 14 00 BR 41 24 
0810- 09 17 0B IC 08 80 00 M 
0818- 00 

As Mored in memory Applesoft program lines are separated by zeros. All 
progmiB must also begin with a zero. Enter POK£ 20481 : RUM and notice 
the Gia^emjr messages you get This is becai^ byte 2048 ($800) is the 
first byte of our Apidesoft progiBm (and most ottiafs). POK£ 2048,0 is quite 
effi»:tlve ttierapy fiiis mindlessness. 

The two bytes after the zero in eveiy program line g|ve the address of the 
next program line Thus, the 09 08 in bytes $801-€02 indicate the second 
programline is at $080a Tlie n 08 IheiE shews tiK IMid line slarts ^ ^ 
and so on. 

The next two bytes of a program line indicate the line number. The OA GO at 
bytes $805-804 is hexadecmial for m the 14 00 at $80A-80B is hex for 20, 
and so on. This is followed by a series of tokens and ASCII characters. The 
token for IflPUT is $84, as you can see at byte $805. At byte $80D you can see 
PRinrs $BA token, and at byte $815 CUD'S $80. The Applesoft manuals have 
lists of the tokens for all Applesoft commands. 

note that the third line of the program points to a non-existant fourth line 
at $817. Bytes $817-818 both hold zeros. This pair of zeros, along with the 
zero separator marks the end of the program. 

When a program is saved while residing at one location and then rerun at a 
new kxallon, all of the next-line pointers have to be recalculated or the 
program won't execute. DOS 3.5 calls a routine in Applesoft at $D4f 2 that 
handles this. This Applesoft routine ends, howa^er by warmstarttng 
Applesoft rather than by retunun^to Its caUer; D0S53 has to pull some 
seiK3% bnite fon£ tricks to get control back after 

Unlilce D055A Basfc^ystem simplyresets the pointers itsdC It calculates 
the difference between the program'scun«nt address and the address it was 
saved at and ackjs that difference to all the pointers. Obviously, if AIDLTYPE 
says a program lived at $0000 it was saved, this wfll mess up the loaded 
version. Programs sut^jeded to such h:eatment neither RUM ihnt UST 
properly 

As noted in July (page 52) the incorrect AUX_TYPE also causes problems 
with text and binary files. 1 squirmed out of all this then with the line, These 
problems are fixable, but not this month." But ala^, now bi^ have come 
home to roost 

The difficulty here — the reason I weasled around last time — is that there 
is no way to directly reset a file's AUX_TYPE bytes with Basicsystem 
commands. We have to use the ProDOS Machine Language Interface for this. 

Hie ProDOS machine language interface. The MLI, as its name 
implies, expects to be called from machine or assembly language. In 
general, you get ready for a call by setting up a parameter table somewhere 
in memoiy that holds the information ProDOS will need to execute the 
command. Then you jump to a subroutine at the location known as 
MLIETfrKY, which is at the beginning of the ProDOS global page ($BFOO). (The 
ProIX)S global page is a 25&'byte area the ProDOS Kernel uses for storing 
various pieces of information that appOcatkm programs sometimes need 
access to.) 

EachPkfoDOSGommafidhasaspecftpaiameterHi^fo^^ 
ftvnn (me ammnand to miother. You tell the ProDOS kemel which command 
ycHiwant to execute and where in memory you've stored its parameter talde 
by embedding this infonnation in your machine language piogranL The 
a>mnnand byte and two bytes that point to the paranidertabfefo^ 
tD$BFOO,llkethis: 

JSfi MLIENTRY fSBF00) 

.Ofl 8SC4 command 

M $BEB4 address of ptraneter tabU 

BCS ERROR your error-handling routins 

The PlToDOS kemd will dig the command and parameter table address 
out of your program and retwn back to your next insbuction, which should 
always for an enron 



OlpieiK^pipie 75 

TVying to use the machine language interface from inside an Applesoft 
program can get very complex, but I finally found a way we can avoid most of 
the complications (this time). Basicsystem has its own global page (at 
$BEO0), which includes a routine called GOSYSTEM. Basicsystem always 
uses GOSYSTEM to call the machine language interface. In addition, the 
Basicsystem global page contains all of the parameter tables that Basicsystem 
itself uses when calling the kemel. 

Unlike the Mil, which expects an embedded command, GOSYSTEM 
expects the command number to be in the A register, it embeds it where the 
kemel will find it later. Then, using this same command number as an index, 
GOSYSTEM figures out where in the global page the parameter table for that 
command is. It embeds that address also, then does its JSR to the MU. On 
rdum, GOSYSTEM checks to see if an error occurred; if so, it converts the 
mor numbo: returned t>y the kemel into a Basic^tem equivalent before 
pas^iig amM back to the caUa: Ft does no other errcHr handlli^ hcs^iumn 

Basicsystem doesn't care if we use its parameter tables for CMir own NU 
calls. By poking a short madiine language routine into some borrowed 
^lace in the Basic^fstem gfobal page, in Mr we can use QOSY^^ 
make NU calls fi»r us from Applesdl This Is what Keeps the number df 
required pokes to a minimum. 

Inside the Basicsystem global page is a 19 byte area ($BE58-BE6B) that is 
used only when a DOS command is being executed. The numeric values of 
the command parameters (the $2000 in BIDAD RED. LEAVES A$2000, for 
example) are stored here when a command is parsed or translated into DOS 
talk. As long as a command isn't being executed, we can temporarily borrow 
some space in this area for a small machine language routine. Here's the 
one we'll use; 

BZSa-.m 00 im trsconnand nunber 
BE5ft:20 70 BC JSR GOSVSTEH t«BE7t) 

0!:5D:B0 ftfl BCS ERROUT ($8E09— entry to Basic. system's error handler) 

BE5F:G0 RT5 

The two MLI commands that are used to diddle w\h AUXJTYPE (or other 
information stored in a file's directory entiy) are QET_f ILELIMFO ($C4), and 
SETJ^ILEJnro ($C3). Since the two parameter tables used by these 
commands are nearly identical, Basicsystem uses the global page area from 
byte 4B820 ($BEB4) to byte 48837 ($BEC5) for both of them. Mere's what the 
tables look like: 



I FIFItID 



GCT_PILE-JNPO 



SETJIUUHFO 



:point«r to fll«'s:^i 



po Inter to flla'Sv:; 




ProDOS pafam«t*r UM«s 

GET_FILEJMFO tells you what is currently stored in a file's directory enby. 
The QETJ^lLEJrfFO parameter table holds ten itema Because some of this 
information can't be changed, the SET_FILEJ]1F0 parameter table holds 
just seven of these ten. The first item in each table, the parameter count 
indicates how many parameters are in the table. The ProDOS kernel uses 
this count to nrake sure the omimmid and paranieter tabte Gonibi^^ 
has been given aie axnpalible. 

ADthekond needs to execute QETJILL^IFOteapmm 
and a pdnter to the pathname of the file being examined. The kemel itself 
fills out the rest of the table. For SET_FILEJP1F0, on ttie other hmA the 
kemd vifants the parameter count to be seven aiKi expects the re^ of the 
tabfetoholdthewduestobestDiedfothefife'sdlredDryentiy 
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Pokingal] this intD the parameter table could be quite tedious; particularly 
the pathname-related pokes. Fortunately, however, from inside the basic 
Basic copy program we can make a few assumptions about what Basicsystem 
has left in this particular table. For example, after either a BLOAD or BSAVE 
command, the pathname pointer will, in fact point to the pathname of the 
file that was just accessed. This will not be true for long, however— 
Basicsystem uses the pathname buffer for lots of stuff— but it will be true 
long enough to soh^e our problems. 

To fix the copy program, we'll call GET_f ILEJIiFO immediately after 
BLOADing the file to recover the original file's true AUX_TYPE; after BSAVEing 
the copy of the file we'll poke the original file's AUXJTYPE into the parameter 
table and call SErr_FILEJriFO to fix the duplicate's directory entry. The 
additional lines you need to add to July's program (page 51) are: 

40S XI =0 : J(2=0 : CMD=0 

45S CI1D=^igG : GOSUa m I XI =PEEK( 48825) : X2=PEEK( 48826) 

475 CMD^ISS : POKE 48820,7 : POKE 4BB25,X1 : POKE 4a826,X2 : GOSUB 600 

G00 REH *** MLI caller for use u^ith Basic. system *** 

501 POKE 48729,169 : POKE 48729, CUD : POKE 48730,32 

502 POKE 48731, 112 : POKE 48732,190 : POKE 48733,176 

G03 POKE 48734,170 : POKE 48735,96 : CALL 48728 : RETURN 

Line 405 allocates memory for the three new variables we have to use (XX 
X2, CMD). Line 455, which is executed immediately after the original file is 
BLOADed, does a QET_FILLJrirO on the file and saves the AU>LTYPE bytes 
as XI and X2. 

Line 475 pokes tJiese values back into the parameter table after the new 
file is BSAVEd, and does a SET_nLEjnFO to update the new file's AUXJTYPE 
field. 

Lines 600 to 603 make a subroutine that pokes our little MLI caller into 
the Basicsystem global page and executes it riote that CMD must be given 
the value of a ProDOS command before using this subroutine. 

Ifictneralor biums up page zero. I've taken a lot of grief about 
subscribers not being able to tell the Bs from the ds in Nardi's Indnerator 
program (pages 17-19) but othewise it seemed bullet-proof. The Indnerator 



is a high-speed garbage collector for DOS 5.5 written by Bill Basham of 
DiversiDOS fame. However, this month a subscriber disco\«red that his DOS 
commands wouldn't execute and his program wouldn't LIST u^en 
/ndnerator was in use and memory was almost full. 

I traced the problem to the modifications I made to the Incinerator. Those 
modifications made the program automatically check the garbage cans 
every time a return was printed and empty them if necessary. Basham's 
original was called manually with an ampersand command. 

His technique works better. The /ncinerator uses a large number of zero- 
page locations whenever garbage is actually collected. If collection occurs 
while something else (such as a LIST or PRINT command) is using those 
locations, problems will occur. 

Our subscriber's program was using the common trick of defining D$ as 
CHR$(13) + CHR$(4). This technique, which works only with DOS 3.3, assures 
everyone that there is always a carriage return before control-Ds. However, in 
this case the CHR$(15)s also forced garbage collection even as Dr Basic vas 
In the midst of printing DOS commands. ITiis messed up enoug)t zero-page 
locations that the DOS commands weren't executed 

There arc two possible solutions. One is to leave the Incinerator 
connected to DOS as it is now. However, test the potential negative effects 
garbage collection could have on your program by poking a zero at byte 
48816^ ($BEBO). When there's a zero at this location, complete garbage 
collection will occur every time a return is printed. If tiie program executes 
properly, it is compatible with tiie /ncinerator as written. Change byte 48816 
l^k to a four and go. Don't expect tiie LIST command or tiie D$ = CHR$(13) 
+ CHR$(4) trick to work, however. 

The other solution is to BLOAD the /rtc(n€ratorat$4000 and change bytes 
16517-18-19 to 234. This will prevent tiie high-speed garbage collection 
routines from being connected to DOS. To run tiiem,you can either connect 
tiiem to the ampersand hook or execute tiiem directiy witii a CALL 48815 
($BEAF). This last technique is very dangerous, however. That particuiar call 
will initialize and erase the disk in the active drive if the Incinerator has not 
been installed. Perhaps a better syntax would be IF PEEK(4«815)=169 THEM 
CALL J^JIS, That makes sure tiie Incinerator is whaf s at 48815 rather than 
the usual RWTS INIT routine. 
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Apple II hacker profile. Apple's marketing experts say that hackers— 
tiie kind of people vrfio read Open-Apple— are mostiy young underfunded, 
and not responsible for a significant portion of Apple 11 sales. Surprise, 
they're wrong Caff -AERLE. recenUy did a survey (I suspect Open-Apple 
readers are very similar) and discovered that tiieir readers' median age is 42; 
three-fourths are college graduates (45 per cent have master's degrees or 
higher); neariy two-tiiirds have incomes above $40,000 (44 per cent have 
incomes above $50,000); more tiian two-tiiirds own or use two or more 
computers (35 per cent own or use 3 or more; 20 per cent, 4 or more); and 
two-fifths of tiiem authorize ttie purchase of computer equipment for their 
employer or organization, Minety-one per cent are males; 48 per cent have 
spouses who use their computer. 

More ttian tiiree-fourths of Caff -ARRLE's readers are programmers. 
About 72 per cent consider themselves intermediafe or expert in Basic; 24 
per cent in assembly language; 19 per cent in Pascal; and 3 per cent in Logo. 
Of course, 100 per cent of tiiem use Apples. This is a group Apple should 
want to keep happy, but when was tiie last time you saw Apple's marketing 
wizards place an ad in this magazine? 

RAN prices are dropping rapidly. You can save big money by buying RAN 
cards witii a minimum amount of memory and installing your own chips. 
This montii you could get a whole megabyte of 256K chips from Micropro- 
cessors Unlimited (24000 S Peoria Ave, Beggs, Okla. 7442X 9ia-267-4961) 
for only $86.08. Tliese were PiEClSO-nanosecond 256K chips at $2.69 each. 
(It takes eight of them to make 256K bytes of memory). These HEX: chips are 
what Applied Engineering put in the last RamWforks card I got from them. 
Apple's new memory card had Hitachi 200-nanosecond chips in the photo 
they sent me. Hitachi chips are a little more expensive, but tiiey supposedly 
run cooler. (The nanosecond rating refers to ttie chip's response time. It's 
appended to the chip's part number. For example, "-15" indicates a 150- 
nanosecond chip.) Miaoprocessors Unlimited includes witii each order very 



specific instructions for installing the chips without zapping ttiem witii static 
electricity. 

A Value Added Reseller or VAR is someone who buys computer 
equipment directly from the manufacturer, adds software or special 
hardware to create a system dedicated to a specific use, and resells it to end 
users. In tiie July issue (page 50) 1 suggested Apple should expend more 
effort cultivating tiiese kind of people. Before tiiat issue even hit tiie mail I got 
an unsolicited brochure from Apple describing their VAR program. All Apple 
VAR sales are handled by a sales agent, Professional Computer Marketing 
Assodates. For more infonnation, contact PCMAS's Dirk Eastman at 800- 
8214779 (800-824-6277 in California) or Tom Babecky, Apple's VAR 
manager in Cupertino. 

ftanklin Computer seems to have resusdtated itself. It has announced a 
new Apple Ile/Ilc-compatible ACE 2000 thatwill retail for $699. The machine 
reportedly has a steel case, 90-key detachable keyboard witii numeric 
keypad, 67-wati: power supply, internal fan, and the FVanklin equivalent of 
Apple's MouseText characters. The machine is made in Taiwan; FVanklin says 
it only has to sell a couple of tiiousand a month to make money. Schools are 
the targeted buyers. 

Steve Jobs has taken his Macintosh development team and gone 
home. The Apple II would never have become worid-famous witiiout him, 
but his contributions to the Apple II family ended years ago. The only Apple 
computer that has ever been a commercial success is the one Steve Wozniak 
designed. The mark of Jobs— a closed system and lots of publicity— just 
doesn't sell. Typically Jobs turned his leti;er of resignation in to several 
newspapers before delivering it to Apple vice-chairman A.C. Markkula, 
according to tiie Wall Street Journal 

Jobs' biggest contribution to Apple was its classy image. I had hoped 
Sculley would retain that However, late word is tiiat tirewomen trading gold 
fritur^, playing basketi^alL and carrying sledgehammers are slated to 
disappear from Apple's ads in favor of copy like. Tour suit is a wee- 
presidential shade of blue. Impeccably tailored: jacket sleeve five inches off 
tiie tip of your tiiumb. Your tie discreetiy suggests tiie position you want as 
opposed to the position you've got" (Please excuse me while 1 lose my 
lunch.) I suspect tiiis campaign will lessen Apple's sales to traditional 
customers more tiian it will increase sales to clotheshorses. The worid goes 
on. Even Sculle/s former foe Coca-Cola abandoned tiie real thing. 
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Apple Assembly Une 



You've mentioned the publication Apple Assembly 
Line several times but I've been unable to find its 
address. HKnihl you please mention it? 

Tony Alley 
APOaY. 

^ple Assembty Une is a montMy newsletter 
published by S-C Software; P.O. Box2B0500; Dallas. 
TX 75228; 214-524-2050. It has been covering 
e^embly language programming for the Apple II 
since October, 1980. The current prices are $18 per 
year for bullc mail $21 for first class mail and $32 for 
international mrmail (It's heavy stuff.) 

S-C Software also produces an assembler for the 
Apple II and sells various books and software helpful 
to assembly language programmers and learners. If 
you need assistance with assembly language on the 
Appfe, these foUcs have produds and experience that 
can help, I have done buMness with them f(ff several 
years ana find tftem contf^etely reliable. 

A few weeks a^go / ordered the ProDOS update to 
S-Cs assembler and got a copy of the Jme 1934 
Assemb^ iuie, which had been missir^ from my 
coU€ClJbn,ltdlsdosedQierBtherarttaitr^newsth^ 
the fONC 7Z0 ($48:0) trkkforavMing bmble with 
the Monitor's G(o) command ^xsn't always work. 
When you issue a Q(o) command from within the 
Monitor the contents of byte 72 are placed in the 
6502's status register. This was discussed in greater 
detail here in Mardi (ps^ W} and (ps^ 
50^31). 

If byte 72 contains garbage when the G(o) command 
is executed, your computer can begin to do very 
strange things, for years experts have recommended 
putting a zero in 72 before exiting the Monitor with 
the G(o) command. But now it turns out that a zero in 
72 will enable interrupts. Interrupts have been 
avaMable on the Apple since 1977, but were rarely 
used until the last couple of years. Consequently, no 
one noticed this interacUon before. 

nowadays, however, it would be tmportai^ on 
manysystiems,AppleAsaemt^UMrecommends 
poldng a 4 in 72 rather than a zero. The most 
frequent use o/POK£ 7Z0 in (^n-^ple has been 
aspaitoftheSM.Lamtechrv^pie.ltni^beworth 
yowrtlme to correct Une 520 (to iX)liE7Z4) in the 
programsonpe^ 13, 24, 45,anid55ifyousaveour 
back issues. 

Apple II phone machine 

I wrote a |»ogram tiiat answers my phone*..big 
hairy deal... anyone with a modem can do that Bi^ 
this isn't any ordinary modem, if s a Novation Apple 
Cat Why anyone buys a Hayes I do not know for this 



thing does what a Hayes can do for about the same 
price plus oodles more. In the novation manual 
there's a demo program that shoie how 10 have the 
modem aim«r the phone wttti speech usii^alAatiBx 
system wired to the auxiliary connector on the card 
(you won't find that on a Hayes). Once connected, the 
program would get the modem to answer the phmie 
and have the VDtrax speak toihe person on the other 
end. 

Since I don't have a Votrax I looked around for 
some other way and found one. The synthesizer is 
called Software Automatic Mouth (S.A.M). ft consists 
of a card and a software routine. Just by accident 
(honestly!) 1 set the slot number for speech output to 
my modem slot Low-and-behold voice over my 
phone WITHOUT wires and no need for the SAM card! 
1 was estatic . . , my fingers went wild at the keyboard, I 
wrote a program I call the Answering Machine, then 
the Originate Machine (a phone number dial-out 
database). When 1 put the two together I had Phone 
runcUons, which won first place at the computer fair 
hereinWhittjy. 

Andrew Reeves-Hall 
IdOtenmounta 

Whitby, Orrr lin 5M7 Canada 

/ find this kind of software very exciting. I've 
included your address so that people who want 
more information can contact you directly. I'm 
convinced that the Apple I! can be turned into a 
telephonethatwouldgiveATSn'and other t^ephone 
mmufacturerstheheebie-Jeebies, (Here'ssomdhlng 
interesting to do with anAm>le U-Plus,) 

Fbrseversdyears nowthe ms^orSai^r^ and Loan 
in I^ansas, Oyjttot ftederal has offered a telephone 
bill payment senice. It consists ofasynthetk txnce 
that answers the phone and teMs you what to enter. 
You respond by pushing buttons on a touch-tone 
phone. Systems like this can now be built out of 
Apple lis. 

They could be used to take orders, to quote prices, 
to leave messages, and to retrieve messages. And all 
this could be done at a price the big manufacturers 
couldn't touch. I think I hear opportunity knocking. 

Another single-drive CONVERT 

I find the 11c /UTIUTIES disk unsatisfactory for 
convertins files behtfeen ProDOS and DOS 3.3 on my 
sit^e<lrive Apple He. Since the program will only 
convert an entire disk, a tot of disk switching is 
invoked Just to convert a single file. 

1 couMn't get CONVERT from the /USERS.DISK to 
woili either. You presented one solution for this 
problem in the September issue (page 72). My 
solution involves an extra step, but it still seems to 
save time: use the ProDOS /RAM disk, To convert DOS 
3,3 to ProDOS, use /RAM as the destination prefix. 
When finished with COMVERT, run FILER to copy tiie 
file from /RAM to your ProDOS disk. To convert the 
other way run TILER first to transfer the ProDOS files 
to /RAM and then convert them onto a DOS 3.3 disk. 

Another /RAM disk tip: When starting work on a new 
program I transfer the utility programs 1 am likely to 
need to a new disk (QPLE and APA for Applesoft 
programs, for example). This often involves several 
source disks, and could mean some serious disk 
switching with a single drive. An easier way is to use 
the /RAM disk as a staging area: use FILER to copy all 
the individual files or programs fr^om their respective 
disks to /RAM and then copy ttiem from /RAN to a 
fresh disk witti me wildcard. 

Andrew K. Messersmith 
Ft Lauderdale, fla. 
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Auxiliary memory fix 

At the junior college where my job is to keep the 
Apples running, we've had seveial lies develop prob- 
lems with auxiliaiy memoiy Symptoms included 
machines lockli^ up, unusual charadiafs showing up 
in l>Hter files, and programs Isd^ 
the second 64Kbank of memoiy. 

The manual that cmne with Applied Engineering's 
7r80 card tipped me off to check the chip at position 
B-2 on the lie motherboard. This chip is a 74 LS-245. 
Apparentiy the quality of this chip varies greatiy fi'om 
manufacturer to manufacturer. Applied Engineering 
suggests replacing this chip with one made by Texas 
Instruments. 1 have found tiiat this simple change 
fixes auxiliary memoiy problems at least half the 
time. 

As it happens, there is usually a Texas Inshnments 
74 LS-245 at position B-4 on Apple auxiliary memory 
cards. I've had good results by just switching these 
two chips, though it would probably be better to buy a 
new Texas Instruments chip for the motiierboard. 

When these problems started^ I also called the CaU 
'AEELA hoUine and was told a few Apple lies were 
manu£«lured vidth a 74 LS-109 at motherboard 
position 0-1 This chip is supposed to be a 74 S-109 
or 74 F-109; tiie LS-109 won't work h^e. 1 haven't 
actually found any lies witii this problem, however. 

Jim Luther 
Kansas City, Mo. 

Bulletin board follow-up 

Thanks veiy much for including my questions and 
comments in the July issue of Open-Apple {page 
53). We ordered a Sider hard drive for my departments 
lab and it arrived a few weeks ago in a very well- 
packed box. It almost seemed as though they were 
expecting it to be handled by the gorilla in Uie 
Samsonite luggage commercial tiiough thankfully 
this wasn't the case. We now have a ProDOS version of 
die QBBS bulletin board you mentioned purring 
along (aft;er a few minor adjustments) on the Sider 
witii a Hayes Smartmodem 1200. 

The people at Micro Data were very helpful in 
getting their bulletin board on line. 1 also had to call 
technical support at First Oass Peripherals and 
found them helpful, too. 

I obtained a He enhancement kit and greedily 
popped in the new RO^fs, expecting nothii^less than 
a fianiare and fireworks upon boot-up. That didn't 
happen (and I'm glad ), but I got the equhralent bang 
for the bud( in terms of new features and enhance- 
ments. The direct entry of ASCII comes in hand^, and 
many bugs were fixed. 1 like the new self-test routine 
very much. According to tiie source listing on page 66 
of the Enhanced lie Programmer's Guide, the new 
self-test covers both main and auxiliaiy memory and 
tiie MMU and lOU chips as well. 

Afiiend mentioned thatthe screen-clear time when 
using a terminal-emulation program seemed much 
improved with the enhanced chips, so 1 set up a litUe 
test and found the new routines are over 5.5 times 
faster. 

1 read somewhere that rerunning Basicsystem is 
the ProDOS equivalent of DOS 3.3's FP. Does doing 
this also reset all die MLI links and tiie global page? I 
ask this because 1 often edit my bulletin obard with 
the ProDOS versron of QPLE, then execute Basfc.system 
again so QPLE mn't cause hiccups with QB5S. Is the 
propa^ u^y, or should 1 Just power down and restart? 

PeterChin 
Brooklyn, r).Y. 



78 Open-Apple 

The ProDOS equivalent offTis ' SASlCSYSTm'\ 
This will reload Basicsystem and set up a new copy 
of the Basicsystem global page. It will also reset Uie 
memory-protection bitmap in the ProDOS global 
page, however, it doesn't fbc any other changes that 
might haue been made there (none should be, but 
who knows?) If this might be a problem, you can do 
a "-FRODOS" to restart completely anew without 
actually powering down. 

Thanks for pointing out the source-code-embedded 
description of the enhanced He self-test which I 
hadn't noticed before. It says the test will run 
continuously as long as the open- and closed-apple 
keys are both depressed or the keyboard is discon- 
nected. At the end of a successful test a "System OK' 
message will appear. You can execute another test 
cycle by pressing both apple keys again or you can 
exit the diagnostic routines by pressing control- 
reset 

Releasing the power 

When I read my first issue of Open-Apple, I was 
pleased enough to order all the back issues. 1 said 
more "Amens" reading them than I usually say at my 
(Baptist) church. The folks at Apple, Inc. should not 
read Open-Apple, they should memorize it There's 
more sense in your columns in the April and July 
issues than in all the collected wisdom of Apple's 
management if their blunders are any indication. 
One hopes that the reorganization will help. But why 
don't they save the money and simply implement 
your columns? 

At the university where 1 teach, our department 
(sociology— not computer science, of course) has 
finally persuaded the powers-that-be to begin a 
microcomputer lab with a dozen Apple lies. And, at 
last our computer center director (who is wedded to 
Hewlett-Packard) has agreed to help us interface the 
Apples with the HP mainframe. Maturally. it turned out 
there was already software to do just that Therefore, 
we will have fiill access to all the computing power of 
the mainfi-ame as needed (and at relatively low cost 
compared to buying HP equipment). 

To me, this is the future: good "old " Apple lis 
serving as the base of ever-expanding computer 
capability through enhancements and interfaces to 
larger computers when necessary. Most of the time, 
the Apples can do the job off-line. Today the HP 
mainfi-ame was "down." As my colleagues sighed and 
fumed, 1 happily worked away with my word processor 
and data files on my Apple. 

Long ago, 1 realized that computing was as much 
political as technical. 1 realized that the computer 
professionals often had a vested interest in the user's 
ignorance and dependence on the "experts." And 
that is the great thing about the Apple-led, microcom- 
puter revolution— it is "releasing the power to 
everyone." 

Alan G. Hill 
Greenville, S.C. 

Amen. 

Call for Apple Writer calling help 

1 have a couple of questions about Apple Writer 2.0. 
One of the reasons 1 upgraded to the ProDOS version 
was for the communications capability, but 1 haven't 
been able to figure out how to get it to work with my 
modem (this is embarrassing because 1 consider 
myself a knowledgable Apple user). The Apple Writer 
manual provided no help at all ("Call your receiving 
party using the instructions that came with your 



modem ..." Does that mean 1 have to exit to Basic to 
use my modem with Apple Wet? 1 have a Hayes 
Micromodem lie and would simpiy like to dial the 
number of a local BBS and use Apple Wetter instead of 
Smartcom I 

I would also like to know if there is any way to get 
A^ple Writer 2.0 to date files without a dock card, the 
way AppleWorks and SuperCalc5Ado. 

My last comment is on SuperCalc 5A. It is a super 
program. 1 recommend it to anybody that needs a 
powerfiii spreadsheet for IJie lie or the 11c 

James PCooney, Jr. 
Billings, Mont 

/ consider myself a knowledgeable Apple user, 
too. Maybe that's our problem. 1 haven't been able to 
figure out the Apple intercommunications option 
either. Has anyone out there gotten it to work? flow 
did you do it? 

I suspect the problem may be that you and I both 
have slot-resident modems, Apple's own Access II 
communications software works only with modems 
connected to a serial card, according to a February 
1985 review by Walter Mossberg that appeared in the 
Washington Apple Pi newsletter. Mossberg calls 
Access II "one of the worst products Apple has ever 
offered", in large part because its inability to work 
with slot-resident modems, by far the leading type of 
modem used with Apple Hs, isn't revealed on the 
outside of the package or in the tutorial program. It 
is first mentioned more than 20 pages into the 
manual and must come as a bitter surprise to 
many," Mossberg says. 

You can use the STARTUP program on the ProDOS 
/USERS.Dm to tell ProDOS the date and time, m 
the program and set the prefix to the directory your 
Apple miter files are in and enter ''-AWSYSTEM". 
The date and time you set will appear on all files 
saved that session. You could also modify the 
/USERS.DISI^ startup program to create a special 
Apple Writer startup program. 

SupeiCalc 5A is the most powerful spreadsheet- 
plus-graphics program for the Apple 11 that I have 
found. Its obvious CP/M heritage bothers me, however, 
its developers either didn't bother to learn the 
standard Apple 11 user interfaces or ignored them. 
For example, you can't initialize new disks from 
inside the program. This is standard operating 
procedure on CP/M systems but quite unusual for 
commercial Apple II software. Being forced to press 
the escape key before pointing at cells (while building 
a formula) is something I find particularly bothersome, 
but that's probably my own problem. Although the 
SuperCalc developers are to be congratulated for 
including the ability to use command or exec files, 
they left out a true macro capacity like Lotus 1-2-3 
has. Mow much longer do we have to wait for that in 
the Apple U world? 

Okidata 92 meets AppleWorks 

Jerry Oine asked how to put an Okidata 92 printer 
into correspondence quality w^en using AppleWorks 
(September, page 71-72). 

On the Okidata 92/93 and 192/193 printers, 
correspondence quality and boldface (emphasized/ 
enhanced) are not the same. Correspondence quality 
is obtained by sending the printer ESC 1 Emphasized 
or enhanced is obtained by sending ESC H or ESC T 

The way to get correspondence-quality printing is 
to incorporate the ESC 1 control codes into the 
command that govern the diaracters-per-inch to be 
printed. The command for 10 characters-per-inch is 
control-\ Correspondence quality at 10 characters- 
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per-inch can be had by using ESC 1 control-^ as the 
control code. 

Data-processing-quality printing is selected with an 
ESC 0. 1 code 12 characters-per-inch as ESC control- 
\ to give me rough draft copy at high print speeds. 1 
use the slower correspondence quality for finished 
work. 

This allows the boldface command to be used for 
boldface or another purpose. The other purpose 1 
use is to select an alternate character set. The 
Okidata 92 has a RAM memory area that can accept a 
second set of characters. There are software packages 
(Personal Touch by Okidata. for example) that allow 
you to load italics, script greek, math, and other 
special characters sets. This needs to be done before 
you startup AppleWorks. 

The Okidata prints the alternate setv^en it gets an 
ESC 2. 1 define boldface begin as ESC 2 and use the 
boldface begin command {or control-B fi-om the 
keyboard) to get the alternate characters. Boldface 
end is then either ESC 1 or ESC 0. 

Bruce WRistow 
540 Antlers Dr. 
Rochester, n.Y. 14618 

I've included your complete address so that further 
Okidata 92— AppleWorks questions can find their 
way directly to you. The print samples you sent 
(which included a two-page demonstration of using 
an alternate character set to print the equations 
needed in mathematics and physics texts) were 
beautiful 

Many printers have the alMy to use aftemate 
character sets, including Apple's Dot Matrbc Printer 
and Imagewriter. Apple's documentation barely 
mentions this, however, and certainly doesn't show 
you how to do it Programs that provide alternate 
character sets for various printers are available from 
Third Wave Technology, 16309 Elsienna Ave, Cleve- 
land, Ohio, U155 (216-671-8991) and from Wberg 
Brothers Computing, P.O. Box 4576, Madison, Wise. 
53711 Both companies have a reputation for reliable 
products at reasonable prices, but 1 don't have their 
currentproduct listings handy. 

Apple lis in real estate 

After seeing you recommend Time Is Money (Sep- 
tember, page 71), 1 wonder if you could help me. 

1 have purchased two programs for property man- 
agement and neither one serves the purpose. They 
are The Landlordand Continental Software's Property 
Management When 1 asked Contintental for help 
they recommended I take the program back to my 
dealer and get my money back. The situation with the 
other is similar. Let's say I'm somewhat ticked-off. 

Are there any other property management programs 
that you know of? Neither of the above provide "user- 
friendly" operation. You almost need another program 
to identify the entities in the programs. 

Currently 1 am using Time Is Mone^/for transaction 
entries and the AppleWorks data base for tenant 
owner, address, rent and other informational entries. 
AppleWorks generates my reports. It sure would be 
nice to have ail this wrapped in one program, however. 

Al Smith 
Fresno, Calif. 

Til open this one up to our subscribers. But I doubt 
you will find anything much better than the Time Is 
Money/J^ple)^rks combination. A company named 
Intuit (540 University Ave, Palo Alto, Ca/t^ 94501 415- 
322-0573) recently announced acheckbookprogram 
named Qtddcen ($79—128K required) that has two 



bnpoiM/^aCioes (ftat / wish line Is ffo^ 
an ^p^ibfks-like user interface and the ability to 
transfer data directly into AppleWorks spreadsheets. 
As I understand this second feature (it was disabled 
in the demo disk they sent mel you set up an 
AppleWorks spreadsheet with special labels for the 
data you want, then you start up Qukken, tell it 
about the spreadsheet file, and it imll find it and fill in 
the data. You return to AppleWorks to see the finished 
spreadsheet 

Muit's program reminds me of the Pf S series. Like 
Software Fublishing's stuff it sacrifices features for 
em^-usR and it's written tn Piascai It is stridten 
M the letftargtc response t^cal ofPamA-based 
U software. Qukken um ru4 the name th^ 
came to mind u^n I tried the prpgiam. Ifaie Is 
Mmi^lsinltn^b^randfastNilsurewishU 
coiMpassMatoa^readi^heetsomehomhoweoer, 

The hard disk life, continued 

Thanks for the comment (August page 63) on the 
probieni 1 hadi#itheSider(actu9UyaDatai^ 
appar«i% ida^ to a Skier). The baMloc^ 
the files I expeiieiioed by pressing resetwhUe printing 
an Apple Writer file only happened once (that ms 
enoughl). This has the cmlyanopaloiis^b^ 
I have experienced ivftti this hard &sk In several 
hundred hours of operation. Guess I was lulled into 
complacency, so I hadn't bothered to back up my 
files. 

When the bad-blocking problem occurred, the disk 
was on line but not active. I was printing a long Apple 
Writer file, noticed something was wrong, and reflexively 
hit control-reset to stop the printout The file in RAM 
was uncorrupted and I finished my printout then 
attempted to pull up another file to find that I was 
fenced out permanentiy I was four levels down in the 
pathname and lost everything in that subdirectory. 
Ilottung outside that subdirectory was touciie4 and 
Oie drive contbiued to work as it should have except 
for the reduced eiocdve size of the drh^. When I 
reformatted, the media certified Just as it had the first 
time I set It up. 

I have noticed a problem with the AppleWorks 
spreadsheet that I have never seen documented. 
When I rearrange an alphabetized spreadsheet with a 
sort on a column of numerical scores it always purges 
isolated but continguous blocks of cells of their 
formulas so that 1 must rebuild a large part of the 
template. Deleting rows or columns will occasionally 
corrupt other parts of the structure that are in 
independent regions. Apple is of no help, they only 
tell me to contact my dealer, is a new revision 
upcoming on AppleWorks? 

1 wonder why Apple doesn't provide an easier way 
to modify only the tail end of a long patii name — the 
way you can in Sensible Speller's ProDOS version, for 
example. If s a nuisance to have to type in an entire 
pathname when you only want to jump to anotiier 
tw^on the same branch. Nayrbe Yve missed something. 

Donald Deafy 
San Mateo, Calif. 

Apple U u^mti liM^wm^ to sau he 
suspe^yowhwfdtMfmj^m urns caused by a 
rwfiaway print-to-disk opers^n. If the reason you 
pressed reset was thsA ntMng was coming out on 
your printer (because you had selected 8 (print-to- 
disk) as Apple Writer's 'print destinaUon"h reset 
could easily have caused the directory entry to be 
mangled, I haven't come up with any explanation for 
whathapperii&itououthatsraartyasplausable. 



I've never experienced or heard of the formula- 

damage problems you mention with AppleWorks, 
The currentAppleWorks version is 12; I don't know if 
App/e has revisions in the wings but I susped they 
do. They certainly make enough money off the 
program to provide customer support; most 
marketing-oriented companies would love to have 
the customer feedback you tried to provide them. 

You haven't missed anything that I know about 
regarding FroDOS pathnames. I agree that the 
ProDOSkemdshouldsiq^iortsome kind command 
forddetSngorrepladng&iefinsAf&enameina 

Another graphic grabber 

IntheJuly^e(''PHntingOiaphlcs^page53)^^ 
discussed a couple of cards that can intenuii^ a 
program at any time and print tiie graphic display. I'd 
like to put in a plug for Dark Star Systems' products 
(78 Robin Hood Way, Qreenford, Middlesex UB6 7QW 
England, Source Mail BCJ456). ( have one of their 
Snapshot copy cards and their Printerrupt and 
Shuttie software. At the time of purchase (about a 
year ago), I was a bit hesitantabout dealing with a firm 
based in Europe tiiat had no local representative. 

Any fears I had proved absolutely groundless. Dark 
Star Systems personnel have proved to be helpful 
and responsive beyond tiie call of duty. With their card 
and its associated software packages there seems to 
be virtually nothing (digital, that is) that you can't get 
out of your Apple onto onto the screen^ disk, or 
printer. 

The copy card itself has ^ of RAN memory into 
whidi you load programs such as Printerrupt This 
program does the same kinds of things as ITiirdware's 
Fingerprint card and Texprinfs Print-it!, but it uses 
the printer interfiace card you already have. The 
Shuttie software lets you run programs under different 
operating systems simultaneously —you do need, 
however, 64K of RAM for each such program you wish 
to have loaded at the same time. 

Dark Star now has a representative here in the U.S.: 
Qreengate Productions, 2041 Pioneer Ct Suite 15, 
San Mateo, CA 94403, 415^345^3064, Source Mail 

BCHl^ PaulPagel 

Enfield, Conn. 

Any company that makes a cop^ card on Robin 
hood Way deserves success. A comparison of the 
rtngerPrint and Dark Star cards in the July 1985 
issue of Apple User an English Apple magazine, 
also came down in favor of Dark Star, though the 
Fingerprint card reviewed was obviously an earlier 
version than the one we use around here. 

Next program, please 

I'm running a He with a Sider hard drive. 1 modified 
the startup program Apple provides with ProDOS to 
allow selection of^pleWorks,;^e Writer, or Sensible 
Spelierin addition to the standard HLEU COffVERX 
etc 

Can you — can anyone— give me a way to quit each 
of those Uiree programs and get directiy back to my 
menu? Open-apple/control/ reset does itwith detours^ 
I'm iookingforthe directroute, DonaldA. House 
nau^rtiick,Conn. 

I solved this problem by renaming the flrst volume 
on my Sider "//fl" (it's simple— use the ProDOS 
HEFiAME command) and puUing a second copy of 
Basicsystem, named QO, on that volume. (FP would 
be another suitable name.) 

Commerciai-quality FroDOS<on^>atible software 
Is sup|)osed to Issue a '"quit" cailtothe ProDOS 



kemd at exit 77te programs you i 
ejcceptton of FILER and CX)rMm (loftfcfi fao peapie 

would say are commerdal-quaUty anifuml do CMsl 
The quit routine inside ProDOS, whidi Apple calls a 
dispatcher'' asks you to enter a prefix and a path- 
name. It's pretty easy to enter /til and GO; on my 
system this brings up my own menu program, 

A more advanced technique would be to rewrite 
the ProDOS dispatcher. The ProDOS developers 
expected people to do this and have made it pretty 
easy. The dispatcher code is embedded within the 
ProDOS kernel at bytes $D100-$D3FF in the second 
4K bank of main memory. When ProDOS executes a 
quit call it moves a of Ihe dlsps^tdier to $1000 
andjumpstoit 

A better assembly tar^uag^ dlspakhet coM be 
written Utat would mdomatkMy run Basicsystem 
andyourApplesoftmenuprogram. This would msdce 
a nice project for someone. Yd do if I ootiM : 
find a time warp to hkte In till 11 toas (foiie. Anyone 
who wants to try shovHd r^d Apple's ProDOS Techni- 
cal ffotes #7 and #14 before starting. There's a slight 
chance your dealer's technicians would have these. 
They are also availMe m most user group software 
Hbrarksondtsk/IAC^, 

Ybu can say that again 

JoabsorJahbs? 

B. Walters 
Boston, Mass. 

According to the press reladons department at 

Apple, it'sjahbs, as in ]obs for the poor" spoken by 
someone from Kansas City. But who knows how you 
Bostonians might pronounce it? 

Time short for ProDOS 

The PToDOS feature that enables a Thunderdock 
todate^tamp flies exph^ on December 31 1987< On 
January X 1988, ProDOS vaU stamp your flies 1 JAM 
82. This results firom the ws^ that ProDOS dolves the 

year. 

The dock that the PtoDOS designers dedded to 
support the Thunderdock, doesn't keep track of 
whatyear it is. So FroDOS has to perform a calculation 
based on the current date to figure out what day of the 
week it would be if it were 1984. It then subtracts the 
value found in Thunderdock's day of week register 
from this value, and uses the resulting ofl^t as an 
index into a 7-byte lookup table that contains the 
corresponding years. 

in all ProDOS versions to date this table contains 
the sequence $54, $54, $53, $52, $57, $56, $55. 
These are the equivalent of decimal 84, 84, 83, 82, 87, 
86 and 85 respectively, which are the years in which 
these versions of ProDOS (unction properly. To 
breathe new life into either of these versions of 
ProDOS, you can change the first four bytes of this 
taUe to $5A. $59, $58, $5a This will ^dend its 
usefiitaiess to the Old of 1990. Keep this tilde tudied 
away in your reference file, in case you are still ushig 
the same ProDOS five years from noK notice that a 
leap year must be reported in two suGOS^ bytes, 
and 0iat the table maps around from ilie last byte 
badi to the first (years in descending order). 

To make a patch, BLOAD PRODOS, A$2000, TSYS. 
flow you can find the offending bytes in main RAM, fix 
them up, then BSAVE PRODOS, A$2000, TSYS. notice 
that you don't have to give the L parameter when 
saving— ProDOS will use the one stored in the 
directory 

When you BIX)AD ProDOS at $2000 the table of 
years is at $5076 in ProDOS 101 and 10.2 and at 
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$4f 76 in versions U and lU After testing the patch 
to make sure everything woriis OK, you can copy this 
updated PRODOS file to all of your bootable FroDOS 

disks. 

A second approach to the problem is to change the 
year-lookup ro^tine and track the year separately in 
your STARTUP program. The command that picks the 
year out of the table is B9 B8 fl {LDA ($F1B8KY} in 
versions 10.1 and 10.2 and appears at $5050. in 
versions 11 and m the command is B9 B8 D7 {IDA 
{D7B8),Y } and is at $4r50. In either case, change it to 
ADEF03{LDA$03Er}. 

flow you can keep the month and year in a text file, 
and have your STARTUP program compare the month 
currently shown on the clock to that last written to the 
file. If the current month is less than the month found 
in the file, you add 1 to the year. In any event, you 
rewrite the file so it contains only the current month 
and year. Then you POKE the year into a new "date 
stamp buffer" we have just aeated at location 1007 
($5Er). As long as this disk gets booted a couple of 
times a year it will never get out of date. A word 
processor can easily make any collection required 
as a result of extended dormancy. 

I used this second method because I had to rewrite 
the ProDOS clock driver to work with my Mountain 
Computer AppteClock, which has neither year nor 
day of week. If you usetheThunderdock, if s easier to 
just patch up the year table once every five or six 
years. 

Clay Ruth 
Dyer, Ind. 

Gotcha, Sider, ProDOS 

I recently tracked down a bug in a program that was 
trying to PEEK at the expansion area ($C800-CFFF) 
firmware on an interface card. Something was myste- 
riously turning the expansion area off just as 1 tried to 
PEEK at it All interface cards are supposed to turn off 
their expansion area ROM when the value $CFFF 
appears on the address bus; some cards do it for any 
value in the $CF00-CFFF range. 

In tracking down the problem 1 learned that the 
6502 has a bug in it that causes the wrong address to 
momentarily appear on the address bus when an 
indexed instruction aosses a page boundary. For 
example, tiie inshnction LDA$CFDC,Y (which appears 
within Applesoft at $DF3F), with Y holding $C4 (as it 
doeswhen PEEKis executedMs supposed to load the 
A lister with the value at and it does. 
However, it also momentarily puts the address $CFAO 
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($100 less than the con-ect value) on tiie address bus. 
. This makes some peripheral cards, including tiie one 
1 was trying to PEEK at turn off their expansion ROM. 
Gotcha, 

The version of DOS 3.3 that comes with the Sider 
hard drive is only four bytes different from standard 
DOS 3.3. You can boot off a floppy and enable the 
Sider with the following patch: 

10 REM *** Sider enable patch *** 

20 REM Assumes 4BK DOS 3.3 

30 BD00 = 48304 : 5LDT - ? 

40 POKE BD00,32 

50 POKE BD00+1,1? 

60 POKE BD00+2,192+5LDT 

70 POKE BD00+3,0 

By the way, the Sider doesn't seem to follow the 
MSLOT protocol Ibr the expansion area ROM. This 
lightly documented protocol says that peripheral 
cards should store their $CslotvaIueat$7re (MSLOT). 
MSLOT can then be used at the end of an interrupt 
routine to reset the expansion area if the intemipt 
has used the ©q>ansion ROM on other peripheral 
cards, 

I have also recently spent some time figuring out 
what ProDOS checks during booting- this may be of 
interest to others. After checking the $F8 ROM 
identity bytes to see what machine if s in, testing for 
theamountof RAM present, and preparing the results 
for saving later in the machine ID byte ($BF98) in the 
global page, ProDOS scans the slots for disk devices 
and other cards. 

The scan starts at slot 7 and works downwards, 
first ProDOS looks for a disk interfiace card. I'll 
describe this in more detail later. If a disk interfiace 
isn't found, ProDOS next looks for the Thunderdock 
signature ($08 at CsOO, $28 at $Cs02, $58 at $Cs04, 
$70 at Cs06). if a clock is found, the appropriate bit is 
set in Qie machine ID liyte and the clock routine 
vector is enabled in the global page. 

Failing that the slot is tested for the Pascal 11 
interface card identification bytes ($38 at Cs05, $18 at 
CsOZ $01 at CsOB). If this much is found, byte $Cs0C, 
the Pascal 11 device signature byte, is checked for an 
80-column card. Before ProDOS version 11 this byte 
had to equal $88, which is the ID for Apple's own 80- 
column "card". In version U and later, only the high 
nibble has to equal 8, the low nibble can be anything. 
Since the low nibble is supposed to identify the 
manufacturer, the newer versions of F^oDOS will 
accept anyone's 80-column card. 

If tfie three tests for a disk controller card, a clock 
card, and an 80<»Iumn card all fail the slot is simply 
checked to see if a ROM is present If so, the appropriate 
bitisscttolintiieglobalpage'sSLTBYT($BF99)flag. 
After all slots have been checked, a routine is called 
tiiat does a checksum on tiie RON to confirm tiiat a 
genuine Apple II is in use. If tiie routine Ms it hangs 
the system. 

Mow for the interesting part If the disk interfiace 
card search finds the correct signature ($20 at $Cs01 
$00 at $Cs03, $03 at $Cs05) in a slot it then checks 
the last byte in that card's ROM space, $CsFF. If that 
byte is zero, the card is assumed to be a standard 
Apple II floppy controller. If the value is $FF the card is 
assumed to be an older DOS 3.2 13-sector controller 
and is rejected. Otherwise the value is saved for later 
placement in the global page, along with $Cs, as the 
entry point for access to the device, 

Next the byte at $CsFE is checked. This is supposed 
to be a status byte that defines the characteristics of 
the device hooked to tiie disk controller. If tiie device 
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doesn't support read and status calls (bits and 1 
equal 1), tiie card is rejected. Bit 4 of tills byte is used 
to determine whetiier the device has two volumes (0 
means 1 volume, 1 means 2 volumes). Botii are 
assumed to be tiiere if if s a floppy drive. Bit 5 is not 
tested. The ProDOS Technical Reference Manual says 
on page 110 that bits 5 and 4 of the $CsFE status byte 
indicate the number of volumes available on the 
device. TWo bits indicates the possibility of four 
volumes, but tiie Apple manual says the possible 
range is zero to two— how many files does it take to 
fill zero volumes? 

The top nibble of tiie status byte is shified down 
and saved, in tiie global page's device list at $BF32- 
3f, as ttie low nibble of the device ID. The meaning of 
tiie device ID then becomes DSSSRIW, where D is the 
drive number, SSS the slot number, R whether the 
device's storage medium is removable (l=yes), I 
\^^iether tiie device is interruptable (l=yes), and W 
tiie number of volumes on the device. ProDOS zeros 
out this lower nibble when using tiie device ID to call a 
disk driver. 

Drives are added to tiie global page's device list as 
tiiey are found and tiie device count (DEVCriT, $BF31) 
is incremented. If bit 4 of the controller card's status 
byte indicates two volumes are available, both are 
added to the device list After the scan of ail slots has 
been completed, this list is shuffled so tiiat tiie boot 
drive is placed first followed by the others with the 
highest slot first This becomes tiie order in which 
drives are seardied when a volume isn't found in the 
defiault drive. 

TomVier 
Reston,Va. 

Vve run into that bad-addres&on-the-bus-with- 
Mexed'instudions problem before, ProntoDOS 
Qoesarazy IfyouUytosaue&ie fintwmre onthe card 
in siot 1 urfOi a BSAVE FammA$C100MOO 
command, PioiiloDOS uses an indexed instruction 
with the base badi in page $C0 for this and all the 
Apple's softswi^hes get hit as the file is saved. What 
a mess. The newer 65C02 doesn'thave this problem, 
nonetheless, people writing firmware for cards that 
might end up in slot 1 should be careful not to use an 
indexed instruction with a base in page $C0. 

The information you've developed on the Pro[X>S 
initialization routines is very interesting, especially 
the part about the meaning of the lower nibble of the 
device ID. Fiote, however, that while the 4 that the 
Frorile and the 5 that the Sider put in this nibble 
make sense, floppies place a there instead of the 9 
you would exped, and /RAM shows upas$F instead 
of a more meaningfid 4. The purpose of having two 
bits in the $CsFE status byte to indicate the number 
of volumes available rather thm one escapes me 
completety. Since only one of the two bits is actually 
tested it would appear ProIX)S expects only one or 
two volumes per device. Once a device is catted, of 
course, it coidd pface additional volumes into the 
device list using phantom slot assignments; but 
nothing limits this tridi to four volumes. Bit 5 /oo/cs 
meaning/ess to me. 

The hang-ifchedcsum is-incorred feature makes 
FroDOS inoperable on machines with custom Monitor 
ROMs. You can override this useless, arrogantfeature 
by BLOADing ProDOS at $2000 and changing two 
bytes to $£A The bytes to change are: versions 10.1 
and 10.2, $2655-50 version II $264D4E; version 
III $269&9E (In general terms, search for the 
sequence 69 05 DO 03 and change DO 03 to EA EA, 
The enhanced lie Monitor's search command (March, 
page 20: 0B69i2O00.5A0OS) works great for this.) 



